.. _cmsHomeSetSpeedPattern_T:

cmsHomeSetSpeedPattern_T
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmsHomeSetSpeedPattern([in] VT_I4 BoardID, [in] VT_I4 Axis, [in] VT_I4 PhaseID,
    [in] VT_I4 SpeedMode, [in] \VT_R8 Vel, 
    [in] VT_R8 AccelTime, [in] VT_R8 DecelTime)          

DESCRIPTION
`````````````  

- cmsHomeSetSpeedPattern_T() 함수는 설정된 축의 원점복귀 속도 단계와 속도 모드, 가감속도 
  및 작업속도 등을 설정합니다.   

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cms 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis : 축(채널) 번호. 축번호는 상수값으로  0번째 채널을 기준 채널로 임의의 채널을 
설정할 수 있습니다. 
 
▶ PhaseID : 원점복귀의 속도단계를 설정합니다. 
PhaseID는 번호로 분류됩니다. Phase 0은 처음 원점신호를 찾을 때 속도를 의미합니다.  
Phase 1은 원점 복귀모드 중 원점신호를 찾고, 원점신호에서 나오는 Phase를 수행할 때 
사용합니다. Phase 2는 Phase 1를 수행하여 원점신호 벗어난 축을 원점신호로 접근하는 
Phase입니다.   

▶ SpeedMode : cmsHomeSetSpeedPattern_T 함수의 인자이며, 원점복귀시의 S-Curve 형 또는 선형 
가감속, 가감속이 없는 모드등을 선택할 수 있습니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| 0 또는 cmsSPEED_CONSTANT", "
     |                             CONSTANT 속도모드 => 가감속을 수행하지 
     |                             않습니다."
    "| 1 또는 cmsSPEED_TRAPEZOIDAL", "
     |                               TRAPEZOIDAL 속도모드 => 사다리꼴 가감속을
     |                               수행합니다."           
    "| 3 또는 cmsSPEED_SCURVE ", "
     |                            S-CURVE 속도모드 => S-CURVE 가감속을  
     |                            수행합니다."    

▶ Vel : cmsHomeSetSpeedPattern_T 함수의 인자이며, 작업 속도를 의미합니다. 기호로는 Vwork 
로 표기합니다. 

▶ Accel : cmsHomeSetSpeedPattern_T 함수의 인자이며, 홈복귀시의 가속도를 의미합니다. 

▶ Decel : cmsHomeSetSpeedPattern_T 함수의 인자이며, 홈복귀시의 감속도를 의미합니다. 


RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+